home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / cdrom / scsi-gui10.lha / scsi-gui.doc next >
Encoding:
Text File  |  1995-02-03  |  5.0 KB  |  187 lines
  1.  
  2.           /\                                              /\
  3.        _{_\/_}_    SCSIUtil ANSI GUI V1.0 (03.02.95)   _{_\/_}_
  4.         { /\ }     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~    { /\ }
  5.           \/                                              \/
  6.  
  7.  
  8.  
  9.  
  10. What is it?
  11. ===========
  12.  
  13. This program is a "Graphical User Interface" to make life easier
  14. with the excellent CDRom-sampling utility "SCSIUtil" by Gary Duncan
  15. and Heiko Rath. It has been written in ARexx and uses ANSI-Codes and
  16. ASCII-characters to render some graphics.
  17.  
  18.  
  19.  
  20.  
  21. Features
  22. ========
  23.  
  24.  - Audio-Tracks are directly accessible
  25.  - opens on any public screens, at any position
  26.  - window size depends on system-fonts (!)
  27.  - handles left/right/stereo recording and 8/16bit resolution
  28.  - can save preferences (is a textfile, so user can edit it)
  29.  - change sample filename or path
  30.  
  31.  
  32.  
  33. What do we need to run?
  34. =======================
  35.  
  36. 1) SCSIUtil (V2.02 or higher) by Gary Duncan and Heiko Rath.
  37.    Can be found on aminet/disk/cdrom.
  38.    Must be loadable from system's pathes (C: etc).
  39.  
  40. 2) Play16 by Thomas Wenzel. Can be found on aminet/mus/play.
  41.    It is needed to play 16bit and 8bit raw samples produced by SCSIUtil.
  42.    Must be loadable from system's pathes.
  43.  
  44. 3) rexxreqtools.library by Rafael D'Halleweyn.
  45.    Absolutely required to interact with user.
  46.    Can be found within the ReqTools Package, available almost everywhere :)
  47.    (see aminet/util/libs)
  48.  
  49. 4) rexxsupport.library by Commodore Amiga. Should be in LIBS: .
  50.  
  51.  
  52.  
  53.  
  54. Getting started
  55. ===============
  56.  
  57. Make sure required programs are available.
  58.  
  59. Usage is: rx scsi-gui [<prefsfile>]
  60.  
  61. where <prefsfile> is an optional file to load as preferences.
  62. It omitted, "S:scsi-gui.prefs" used as default.
  63.  
  64.  
  65.  
  66.  
  67. Preferences
  68. ===========
  69.  
  70. SCSI-GUI tries to load the prefsfile and takes all information from there.
  71. If this file is not available, user is prompted for a device and
  72. a unit. Other variables are set to defaults.
  73. To see how the prefsfile is built, just save it in the program
  74. by pressing P and have a look at it. It is very easy to understand.
  75. You may NOT include any comments in the preferences-file.
  76.  
  77.  
  78.  
  79.  
  80. How to use
  81. ==========
  82.  
  83. "Offset" is the time in Minutes:Seconds:Blocks where to start on the
  84. CD. There are 75 blocks in one second.
  85. "Length" is the time to be sampled, beginning at "Offset".
  86. Use cursor keys to move cursor (white coloured) and +/- to change values.
  87.  
  88. Following keys are triggering actions:
  89.  
  90. SPACE  -  sample and play your selection. If you haven't changed
  91.           anything since last sampling, sample data is played again.
  92.  
  93. P      -  save preferences. By default, saves to "S:scsi-gui.prefs".
  94.           You may deliver another name on startup.
  95.  
  96. B      -  toggle sampling resolution (8bit <-> 16bit)
  97.  
  98. D      -  Destination file selection. A filerequester will pop up to
  99.           let you choose a path and a file to save sample to.
  100.  
  101. TAB    -  toggle between left/right/stereo channels. When in
  102.           8bit-mode, only left or right channels are supported.
  103.  
  104. 0      -  (on mainpad or keypad) prompts user for a tracknumber which will
  105. (zero)    be calculated to the corresponding time-offset. For example,
  106.           if you want to sample the first 10 secs at the beginning of the
  107.           5th track on your CD, type in a "5" (and set Length to 10 secs).
  108.           This action is on the "0"-key to simplify data entry. Just
  109.           type "0" on keypad, then type your track number into the
  110.           requesterwindow! ;-)
  111.  
  112. HELP   -  re-read CD information. Necessary when changing CD.
  113.           On startup, SCSI-GUI does not automatically detect whether a
  114.           cd is in your drive, to prevent error messages to come from
  115.           SCSIUtil if your drive is empty.
  116.  
  117.  
  118.  
  119.  
  120. Why is there no intuition window?
  121. =================================
  122.  
  123. Because I don't have any suitable intuition environment to use with
  124. ARexx. (rx_intui.lib is not Kick2.0 look, rexxarp.lib cannot handle
  125. proportional Gadgets).
  126. So I decided to create "pseudo"-gadgets with ANSI-Codes in a RAW-
  127. Console window. Anyway, this seems to be a fast solution for ARexx.
  128.  
  129.  
  130.  
  131.  
  132. Legal text
  133. ==========
  134.  
  135. SCSI-GUI is copyrighted by me (Sven Thoennissen) and is to be FreeWare.
  136. I will cut your head off if you try to gain any profit with it,
  137. as I don't make any money with it!
  138.  
  139.  
  140.  
  141.  
  142. History
  143. =======
  144.  
  145. V1.0    - First release. Size is 17415 Bytes.
  146.  
  147.  
  148.  
  149.  
  150. Tests
  151. =====
  152.  
  153. SCSI-GUI has been successfully tested under following conditions:
  154.  
  155.  - A4000/EC030, Toshiba XM-4101, Golem-SCSI-II, OS3.0
  156.  - A2000/GFORCE040, Toshiba XM-3501, GVP-Controller, OS3.1
  157.  
  158. You are free to tell me your well-tested equipment so I can add
  159. it to this list.
  160.  
  161.  
  162.  
  163.  
  164. Thanks and hellos
  165. =================
  166.  
  167. To the authors of SCSIUtil and Play16 who gave their permission
  168. for using it. Thanks to the author of rexxreqtools.library for
  169. making reqtools available to ARexx!
  170. Big handshake to Mathias Frankenbach for betatesting and improvements!
  171.  
  172.  
  173.  
  174.  
  175. Contact the author of SCSI-GUI
  176. ==============================
  177.  
  178. For improvements or suggestions email me at sa80@tomate.oche.de or at
  179. svent@pool.informatik.rwth-aachen.de .
  180.  
  181. Please tell me if there are any bugs in it, and tell me your
  182. equipment, too.
  183.  
  184.  
  185.  
  186.  
  187.